home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 6 / Amiga Format AFCD06 (Nov 1996, Issue 90).iso / serious / shareware / archivers / makesfx / makesfx.doc < prev    next >
Text File  |  1992-09-03  |  4KB  |  93 lines
  1. MakeSFX v1.0 by Kyzer/CSG
  2.  
  3. MakeSFX is a very simple creator for SelF eXtracting archives. It is a very
  4. simple, AmigaDOS script that generates an assembly language file of a self
  5. extracting archive, and then assembles it into a real program, which should
  6. be compressed with a packer, eg Imploder 4, StoneCracker, CrunchMania, etc...
  7. The main points about packing like this (if you need a SFX archive in the
  8. first place! remember that passing archives to people is much better to use
  9. LhA or LZX, but they are quite big...) is that unpacking is VERYFAST! It
  10. goes at the maximum speed possible, limited only by hardware! :)
  11.  
  12. REQUREMENTS:
  13. Needs to be run from the shell, with a T: assign set up (usually is, if not
  14. try 'makedir ram:t' and 'assign t: ram:') and the commands 'list', 'delete'
  15. and 'execute' to be available. On a Workbench 1.3 system the commands 'set',
  16. 'unset', 'cd', 'echo', 'if', 'else' and 'endif' must also be available (these
  17. are built in to 2.0+)
  18.  
  19. The programs 'blink' and 'a68k' must be in your path (eg your C: drawer)
  20.  
  21. INSTALLATION:
  22. Copy the files 'a68k', 'blink' and 'makesfx' to your c: drawer.
  23.  
  24. USAGE:
  25. Usage is via the Shell, as follows:
  26.  
  27. execute MakeSFX name dir pattern
  28.  
  29. 'name' is the name to give the resultant file, the extension '.exe' is added.
  30. 'dir' is the directory to pack
  31. 'pattern' is an AmigaDOS wildcard for the files to pack.
  32.  
  33. All args are optional, eg
  34. "MakeSFX" creates a file 'make.exe' of all the files in the current directory.
  35. "MakeSFX fish" creates a file called 'fish.exe' of all the files in the
  36. current directory
  37. "MakeSFX fish ram:" creates a file called 'fish.exe' of all the files in ram:
  38. "MakeSFX fish ram: #?.c" creates a file called 'fish.exe' of all the files
  39. ending in '.c' in ram:
  40.  
  41. WARNING:
  42. MakeSFX only creates 'flat' archives, it doesn't recurse into directories.
  43. Why? Well, it's the executable file that is the problem. If you are a
  44. programmer and try to write a file 'fish/fart/flap/hello.txt', the whole
  45. path (fish/fart/flap/) must exist, else the file is not written. Programs
  46. like LhA solve this by recurively creating the directories that make up the
  47. path if they don't exist, but of course this is quite a lot of hard work :)
  48.  
  49. So don't edit the MakeSFX script to recurse (this is simple), the resultant
  50. file won't work!
  51.  
  52. IDIOT EXPLANATION:
  53. If you have the files:
  54.  
  55. file1
  56. file2
  57. dir1/file3
  58.  
  59. With MakeSFX, only the files 'file1' and 'file2' will be added.
  60.  
  61. DISCLAIMER:
  62. Don't blame me if anything goes wrong, it works for me, and it's written in
  63. AMIGADOS!!! Nothing evil goes on, if it don't work for you then you're too
  64. stupid to work it right!
  65.  
  66. TECHINAL:
  67. If you want to, I have included a script 'MakeSFX.phx' which is the same as
  68. 'MakeSFX' except it uses the PhxAss assembler, by Frank Wille. I would have
  69. loved to use the 'FreePhxAss' which is freeware, but sadly it has no 'incbin'
  70. directive, which is needed. And because PhxAss is shareware, I cannot include
  71. it in this archive. But PhxAss is uncrippeled in an way, so you can get the
  72. PhxAss archive from aminet (dev/asm/PhxAss*.lha) and use it instead, for a
  73. 8000% speed increase in assembling (a68k is FUCKING slow! and PhxAss has built
  74. in linking, well, more like a68k doesn't do much work and PhxAss does, because
  75. all assemblers nowadays have built in reloc-generation, there is almost no
  76. need to have a linker, only the C programmers need this stupid program. Who
  77. uses premade link-code anyway?!) Note with modifications ou can use MakeSFX
  78. with ANY good assembler.
  79.  
  80. DISTRIBUTION:
  81. Entirely free, not even a copyright. I don't give a hoot what you do with it,
  82. indeed I'd prefer to see someone write a full SFX program from it, preferably
  83. to directly unpack LhA or LZX files, using overlayed files to reduce memory
  84. needs and have builtin recursive directory creation for non-existing paths :)
  85.  
  86. AUTHOR:
  87. Write: Kyzer/CSG, 49 Fairview Road, AB228ZG, Scotland.
  88. Phone: (01224) 704117 or +441224704117 internationally, after 7pm GMT
  89. INetd: kyzer@adamant (Adamant: telnet 130.83.9.19 port 4711)
  90.  
  91. GOODBYE:
  92. Bye.
  93.